home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2005 October / PCWOCT05.iso / Software / FromTheMag / XAMPP 1.4.14 / xampp-win32-1.4.14-installer.exe / xampp / webalizer / README.FIRST < prev    next >
Text File  |  2004-02-16  |  8KB  |  193 lines
  1. Upgrade information for the Webalizer Version 2.01
  2.  
  3. If you are using incremental mode, the data format for Version 2.01
  4. is incompatable with previous versions, so you should remove your data
  5. file (webalizer.current) and re-process from the beginning of the
  6. month to recreate it.  If you do not use incremental mode, then
  7. V2.00 should be a drop in replacement for 1.3x-xx, with the possible
  8. exception of the two changed command line switches, -g and -F.  In
  9. addition, there has been a number of new configuration keywords and
  10. command line options added.  Please see the CHANGES file for additional
  11. information regarding what has changed between versions.  You may also
  12. want to take a look at the DNS.README file for information on the new
  13. reverse DNS lookup capabilities.
  14.  
  15. ***********
  16. * NOTICE! *
  17. *********** Version 1.30 and higher are INCOMPATABLE with any and
  18. all previous versions of this program. File names have been changed,
  19. and file formats have been modified.  If you are upgrading from
  20. a previous version,  please read this ENTIRE DOCUMENT before you
  21. proceed, as it contains important information that you will need.
  22.  
  23. Note: If you plan on re-processing all of your logs so they will
  24. contain the new statistics, you can safely ignore the rest of
  25. this document (although you really should read it anyway...).
  26.  
  27.  
  28. QUICK UPGRADE INSTRUCTIONS:
  29.  
  30. 1) If you use incremental mode, read the section below, then
  31.    delete your current incremental data file (webalizer.current).
  32.  
  33. 2) Modify your history file (webalizer.hist) as described below.
  34.  
  35. 3) Add any new configuration options that you want to your
  36.    configuration file(s).  (See sample.conf for examples)
  37.  
  38. 4) Rename existing files to use 4 digit year (see below).
  39.  
  40. 5) Re-process your logs from beginning of the month (minimum).
  41.  
  42.  
  43. INCREMENTAL PROCESSING CHANGE
  44.  
  45. The incremental file format has changed, therefore you MUST
  46. REMOVE your current incremental file before running this
  47. version.  Doing so will also force you to re-process all logs
  48. from the beginning of the month, so if you have a large
  49. site, you may want to wait until the end/beginning of the
  50. month to perform the upgrade.
  51.  
  52.  
  53. HISTORY FILE CHANGE
  54.  
  55. The history file format changed as well.  In order to use your
  56. existing history file, you must manually edit it to add two
  57. additional numbers to the end of each line.  These numbers
  58. represent the total 'pages' and 'visits' for that particular
  59. month.  You can do this using any standard text editor.
  60.  
  61. For example, if your existing history file looks like:
  62.  
  63. 3 1999 56614 24758 234 180875 5 31
  64. 4 1999 156711 90240 1529 931048 1 30
  65.  
  66. You should change it to look like:
  67.  
  68. 3 1999 56614 24758 234 180875 5 31 0 0
  69. 4 1999 156711 90240 1529 931048 1 30 0 0
  70.  
  71. Notice the extra two zeros ('0') at the end of each line.  There
  72. will be _at most_ 12 lines for you to change.  You could of course
  73. put some fake values (or real ones if you have them) and they
  74. will show up on the main index page.  If you have access to a
  75. unix command prompt and sed, you could also simply type:
  76.  
  77. cat webalizer.hist | sed "s/$/ 0 0/g" > webalizer.hist.tmp
  78. mv webalizer.hist.tmp webalizer.hist
  79.  
  80. For those curious, the format of the history line is:
  81. Month# Year# Hits Files Sites KBytes Fdom Ldom Pages Visits
  82. (Fdom=First Ldom=Last day of month processed)
  83.  
  84. Note: It may be possible to leave your existing history file
  85. in place, and the first run with the new version will convert
  86. it to the new format.  It works on my linux system, it may
  87. not work on yours...  It depends on how your particular platform
  88. handles the missing data.  Probably better to not chance it ;)
  89.  
  90.  
  91. CONFIGURATION FILE CHANGES
  92.  
  93. Several new configuration and command line options have been
  94. added.  The default values for these should be suitable for
  95. most users,   however you might want to at least define the
  96. PageType extensions for your particular system (default is to
  97. use '.htm*' and '.cgi' extensions).  You should refer to the
  98. CHANGES file to see what has been changed/added. See the files
  99. README and sample.conf for additional details.
  100.  
  101.  
  102. GENERATED FILE NAME CHANGES
  103.  
  104. Previous versions of the Webalizer created html and image files
  105. using a format that included the month and year as two digit
  106. strings (ie: 0399).  Even though the filenames themselves were
  107. _only_ for humans, the Y2K scare has people freaked out over
  108. such behaviour, and I'm tired of getting all the email about it :)
  109. As a result, any existing files need to be renamed to include
  110. the extra two digits.  The old format was MMYY, new format is
  111. YYYYMM (and now they will sort correctly in directory listings :)
  112. For example, change the file "usage_0599.html"to "usage_199905.html".
  113. Image files for previous months do not need to be changed unless you
  114. change the links in the previous month HTML pages as well.  The
  115. current month files will be automatically generated with the correct
  116. names.
  117.  
  118. Mike Glover submitted this little shell script that helps automate the
  119. updating of files/filenames:
  120.  
  121. ------------------------ CUT HERE ------------------------
  122. #!/bin/sh
  123. #
  124. # Mike Glover
  125. # mpg4@duluoz.net
  126. #
  127. # fixalizer.sh -- automatically upgrade webalizer data files
  128.  
  129. START=`pwd`
  130.  
  131. #for each domain...
  132. while [ "$1" ]; do
  133.   DOM=$1
  134.   echo "Updating $DOM"
  135.   cd $DOM
  136.  
  137.   # we don't use incremental mode, so don't worry about it
  138.  
  139.   # modify the history files
  140.   cat webalizer.hist | sed "s/$/ 0 0/g" > tempfile
  141.   mv tempfile webalizer.hist 
  142.  
  143.   # don't worry about new configuration options
  144.  
  145.   # rename existing files to use 4 digit year.
  146.   for ENT in *usage_*; do
  147.     #fixes most names
  148.     NEW=`echo $ENT | sed 's/\(^.*_\)\([0-9]\{2\}\)\([0-9]\{1,2\}\)/\119\3\2/g'`
  149.     #pesky y2k names need repairs
  150.     NEW2=`echo $NEW | sed 's/\(^.*_\)\(190\)\([0-9]\{2\}\)/\12000\3/g'`
  151.     mv $ENT $NEW2
  152.   done
  153.  
  154.   # next iteration
  155.   cd $START
  156.   shift
  157. done
  158. ------------------------ CUT HERE ------------------------
  159.  
  160. ---------------------------------------------------------------------
  161. ---------------------------------------------------------------------
  162. The remainder of this document contains the prior V1.22 upgrade info.
  163. This should only be of interest to those who are upgrading from older
  164. versions of the software and need to see those changes as well.
  165. ---------------------------------------------------------------------
  166. ---------------------------------------------------------------------
  167.  
  168. Upgrade Information for Webalizer V1.21 and higher
  169.  
  170. Some significant changes have occured between V1.20 and V1.21 of
  171. the Webalizer.  Additional configuration keywords have been added
  172. and incremental processing has been modified.  Due to these changes,
  173. the following must be observed:
  174.  
  175. Old incremental data files are no longer compatable with the new
  176. version.  Remove any existing incremental data files before running
  177. the new version.  This version also adds the ability to define the
  178. name and location of the incremental data file.  It will default to
  179. the normal name and location (webalizer.current in the specified
  180. output directory), however can be changed to an alternate location.
  181. See "IncrementalName" and "HistoryName" configuration directives.
  182. Note: you may check existing data files by looking at the first
  183. line of the file... if it doesn't start with "# Webalizer ", then
  184. it is an old style file and needs to be removed.
  185.  
  186. The configuration file has changed, however the only significant
  187. difference is the definition of the HTMLHead keyword, which has
  188. been changed in this version.  If you were using the HTMLHead
  189. keyword in previous versions, change it to "HTMLBody", in order
  190. to have it work as expected (as in previous versions).  See the
  191. README file for additional information.
  192.  
  193.